multisorter: Tweak docs

diff --git a/gtk/gtkmultisorter.c b/gtk/gtkmultisorter.c
index a733f5a275e6da868d4dc9919122e5447696ee91..72d686784b4c0cd01205471708244a4156bba9d9 100644 (file)
--- a/gtk/gtkmultisorter.c
+++ b/gtk/gtkmultisorter.c
@@ -34,12 +34,12 @@
 #include "gdk/gdkarrayimpl.c"
 
 /**
- * SECTION:gtkmultisorter
- * @Title: GtkMultiSorter
- * @Short_description: Combining multiple sorters
+ * GtkMultiSorter:
  *
- * GtkMultiSorter combines multiple sorters by trying them
- * in turn. If the first sorter compares two items as equal,
+ * `GtkMultiSorter` combines multiple sorters by trying them
+ * in turn.
+ *
+ * If the first sorter compares two items as equal,
  * the second is tried next, and so on.
  */
 struct _GtkMultiSorter
@@ -375,7 +375,7 @@ gtk_multi_sorter_init (GtkMultiSorter *self)
  * no sorter has been added to it, it will always compare
  * items as equal.
  *
- * Returns: a new #GtkMultiSorter
+ * Returns: a new `GtkMultiSorter`
  */
 GtkMultiSorter *
 gtk_multi_sorter_new (void)
@@ -385,12 +385,13 @@ gtk_multi_sorter_new (void)
 
 /**
  * gtk_multi_sorter_append:
- * @self: a #GtkMultiSorter
+ * @self: a `GtkMultiSorter`
  * @sorter: (transfer full): a sorter to add
  *
- * Add @sorter to @self to use for sorting at the end. @self
- * will consult all existing sorters before it will sort with
- * the given @sorter.
+ * Add @sorter to @self to use for sorting at the end.
+ *
+ * @self will consult all existing sorters before it will
+ * sort with the given @sorter.
  */
 void
 gtk_multi_sorter_append (GtkMultiSorter *self,
@@ -409,7 +410,7 @@ gtk_multi_sorter_append (GtkMultiSorter *self,
 
 /**
  * gtk_multi_sorter_remove:
- * @self: a #GtkMultiSorter
+ * @self: a `GtkMultiSorter`
  * @position: position of sorter to remove
  *
  * Removes the sorter at the given @position from the list of sorter
@@ -438,4 +439,3 @@ gtk_multi_sorter_remove (GtkMultiSorter *self,
                                 GTK_SORTER_CHANGE_LESS_STRICT,
                                 gtk_multi_sort_keys_new (self));
 }
-